Hachimi Project(Hachimi Patch)

Hachimi Project의 패치 적용 방식은 크게 두 가지로 구분된다. 주로 사용되는 방식은 런타임 패치 방식이며, 특정 경우에는 정적 패치 방식이 병행되거나 단독으로 사용되기도 한다.

런타임 패치 방식은 게임이 실행되는 과정에서 실시간으로 게임 메모리를 후킹하여 코드나 데이터를 수정하는 방법이다. 이 방식은 주로 d3d9.dll, dxgi.dll 같은 DirectX 오버레이 라이브러리를 후킹하는 방식으로 구현된다. 패치 파일(일반적으로 .asi 또는 특정 DLL 파일)이 게임 실행 파일과 동일한 디렉터리에 위치하면, 게임이 시작될 때 자동으로 로드되어 사전에 정의된 수정 사항을 적용한다. 이 방법의 가장 큰 장점은 게임의 원본 실행 파일을 직접 수정하지 않아도 되므로, 게임 업데이트 후에도 호환성 유지가 비교적 쉽고 시스템 파일 무결성 검사에 걸리지 않는다는 점이다.

정적 패치 방식은 게임의 원본 데이터 파일(예: .exe, .bin, .par 파일 등)을 직접 분석하여 특정 오프셋의 코드 또는 문자열을 수정하는 방식이다. 이 방식은 주로 런타임 패치로 해결하기 어려운 저수준의 엔진 제한이나, 게임 초기화 단계에서 반드시 필요한 수정을 위해 사용된다. Hachimi Project에서는 대부분의 기능이 런타임 패치로 구현되지만, 해상도 관련 기본 값 변경이나 특정 메모리 체크 우회 등에는 정적 패치가 적용된다. 사용자는 프로젝트에서 제공하는 패치 툴을 사용해 원본 파일의 백업을 생성한 후, 자동으로 수정된 패치 파일을 생성하여 적용한다.

아래 표는 두 적용 방식의 주요 특징을 비교한 것이다.

일반적으로 사용자는 Hachimi Project의 통합 설치 관리자를 실행하면, 대상 게임에 필요한 두 가지 방식의 패치가 자동으로 분석되고 적용 절차를 안내받는다.

Hachimi Project는 주로 일본의 특정 게임 개발사에서 제작한 비주얼 노벨 장르의 게임들에 대한 한글화를 주요 목표로 한다. 특히 Key (게임 브랜드) 사의 작품들과 그와 유사한 스타일의 게임에 대한 호환성이 두드러진다.

지원 게임 목록은 공식적으로 명시되거나 커뮤니티를 통해 테스트된 작품들을 포함한다. 대표적인 지원 게임은 다음과 같다.

이 프로젝트는 어도비 플래시 기반의 구형 게임이나 특정 게임 엔진으로 제작된 타이틀에 초점을 맞추고 있다. 따라서 최신 고사양 AAA 게임보다는 2000년대 중후반부터 2010년대 초반에 발매된 PC 게임의 한글화 실행 환경을 제공하는 데 특화되어 있다.

호환성은 게임의 실행 파일 버전, 운영체제 환경(Windows 10, Windows 11 등), 그리고 시스템 로캘 설정에 따라 달라질 수 있다. 일부 게임의 경우 정식 패치 외에도 커뮤니티에서 제작한 팬 패치나 버그 수정 패치와의 병용이 필요할 때도 있다. 사용 전 공식 문서나 커뮤니티 안내를 통해 특정 게임에 대한 호환성을 확인하는 것이 권장된다.

Hachimi Project의 설치 및 실행 절차는 비교적 간단하지만, 사용자의 운영 체제와 대상 게임에 따라 세부 단계가 다를 수 있다. 일반적인 절차는 공식 저장소에서 최신 릴리즈 파일을 다운로드하고, 게임 디렉토리에 파일을 복사한 후 실행 파일을 관리자 권한으로 실행하는 것이다.

구체적인 단계는 다음과 같다.

1. 공식 GitHub 저장소의 'Releases' 페이지로 이동하여 최신 버전의 패치 파일을 다운로드한다.

2. 대상 게임의 설치 디렉토리를 찾는다. 예를 들어, Steam 라이브러리에서 게임을 우클릭하여 '관리' -> '로컬 파일 보기'를 선택하면 된다.

3. 다운로드한 패치 파일의 압축을 해제하고, 모든 파일을 게임의 설치 디렉토리로 복사한다. 기존 파일을 덮어쓸지 묻는 경우, 확인을 선택한다.

4. 복사된 파일 중 HachimiLauncher.exe 또는 유사한 이름의 실행 파일을 찾아 관리자 권한으로 실행한다. 이는 시스템 리소스에 접근하기 위해 필요한 경우가 많다.

5. 런처 프로그램이 실행되면, 간단한 설정 옵션을 확인하거나 조정한 후 '패치 적용' 또는 '게임 실행' 버튼을 클릭한다.

설치 후 게임 실행에 문제가 발생하면, 주로 관리자 권한 부족, 안티바이러스 프로그램의 실시간 검사 차단, 또는 게임 버전과 패치 버전의 불일치가 원인이다. 공식 커뮤니티의 문제 해결 가이드를 참고하거나, 게임과 패치를 모두 최신 버전으로 업데이트하는 것이 권장된다.

Hachimi Project의 설정은 주로 hachimi.ini 또는 hachimi-config.json과 같은 구성 파일을 통해 이루어진다. 사용자는 텍스트 편집기로 이 파일을 열어 원하는 옵션을 활성화하거나 값을 조정할 수 있다.

주요 설정 옵션은 다음과 같이 분류된다.

일부 고급 옵션은 게임 엔진의 특정 모듈에 직접 접근하여 값을 오버라이드하는 방식으로 동작한다. 예를 들어, FOV 값을 변경하는 옵션은 카메라 제어 함수의 매개변수를 후킹하여 원래 값 대신 사용자가 지정한 값을 전달하도록 한다. 모든 설정 변경 후에는 게임을 재시작해야 적용되는 경우가 많다.

Hachimi Project의 핵심 구성 요소는 크게 패치 관리자, 게임 후킹 엔진, 설정 관리자, 플러그인 시스템으로 나눌 수 있다. 각 구성 요소는 모듈화되어 독립적으로 작동하며, 서로 통신하여 통합된 기능을 제공한다.

패치 관리자는 사용자가 선택한 패치 파일을 검증하고 게임 실행 파일에 적용하는 역할을 담당한다. 이 구성 요소는 바이너리 패치와 메모리 패치를 지원하며, 패치 롤백 기능을 포함하여 원본 상태로의 복구를 보장한다. 게임 후킹 엔진은 API 후킹 및 메모리 주소 검색 기술을 활용하여 게임 프로세스에 실시간으로 개입한다. 이를 통해 게임 내 텍스트 출력, 그래픽 렌더링 파이프라인, 파일 I/O 요청을 가로채어 수정된 데이터로 대체한다.

설정 관리자는 사용자 인터페이스를 통해 조정 가능한 모든 옵션을 중앙에서 관리한다. 주요 설정은 JSON 또는 INI 형식의 구성 파일에 저장되며, 런타임 시 동적으로 로드 및 적용된다. 플러그인 시스템은 프로젝트의 확장성을 담당하는 구성 요소로, 서드파티 개발자가 Lua 또는 Python 스크립트를 작성하여 특정 게임에 대한 맞춤형 패치 로직이나 추가 기능을 개발할 수 있도록 한다.

Hachimi Project의 동작 원리는 크게 후킹(Hooking)과 메모리 조작을 통해 게임 실행 파일의 코드 흐름을 가로채고 수정하는 방식으로 이루어진다. 이는 게임이 특정 함수를 호출하거나 특정 데이터에 접근할 때, 프로젝트가 제공하는 사용자 정의 코드로 그 행위를 대체하거나 보강하는 원리이다. 주로 API 후킹과 인라인 후킹 기술을 활용하여, 게임이 시스템 라이브러리 함수(예: 파일 입출력, 그래픽 렌더링 관련 함수)를 호출하는 지점을 가로채거나, 게임 코드 내부의 특정 명령어를 변경한다.

구체적인 동작 과정은 다음과 같은 단계로 설명할 수 있다.

1. 초기화 및 감지: 패치 로더가 실행되면, 대상 게임 프로세스의 메모리 공간에 자신을 주입하거나 게임 실행을 감시한다.

2. 후킹 지점 설치: 미리 정의된 후킹 지점(예: 텍스트 렌더링 함수, 파일 로드 함수)을 찾아, 그 주소의 명령어를 프로젝트의 핸들러 함수로 점프하도록 패치한다.

3. 요청 가로채기: 게임 실행 중 후킹된 함수가 호출되면, 원본 코드 대신 프로젝트의 핸들러 함수가 먼저 실행된다.

4. 처리 및 전달: 핸들러 함수는 사용자가 제공한 번역 데이터를 참조하거나 그래픽 필터를 적용하는 등 사용자 정의 작업을 수행한 후, 필요에 따라 원본 함수를 호출하거나 수정된 결과를 게임에 반환한다.

이 과정에서 핵심은 게임의 원본 실행 파일을 물리적으로 수정하지 않고, 실행 시 메모리 상에서만 조작을 수행한다는 점이다. 이는 비교적 안전한 방식으로 간주되며, 패치를 제거하면 게임은 원래 상태로 돌아간다. 또한, 다양한 게임에 적용하기 위해 게임 엔진별(예: Unity, Unreal Engine) 공통 함수나 패턴을 후킹 대상으로 삼는 경우가 많다.

Hachimi Project와 유사한 목적을 가진 다른 패치 또는 모드 관리 도구들이 존재합니다. 이러한 프로젝트들은 주로 특정 게임의 한국어화를 용이하게 하거나, 여러 모드를 통합 관리하는 기능을 제공합니다.

대표적인 유사 프로젝트로는 다음이 있습니다.

이들 도구는 각각 다른 접근 방식을 취합니다. xTranslator나 Translator++ 같은 도구는 번역 작업 자체에 중점을 두는 반면, Vortex나 Mod Organizer 2는 모든 종류의 게임 모드를 포괄적으로 관리합니다. ALI's Project는 Hachimi Project와 마찬가지로 특정 장르 게임의 한국어 패치에 특화된 관리자 역할을 합니다. Locale Emulator는 패치 관리 도구라기보다는 언어 지역 설정을 우회하는 실행 도구에 가깝습니다.

이러한 대안 도구들의 존재는 게임 현지화 및 모딩 커뮤니티의 활발함을 보여줍니다. 사용자는 자신이 플레이하는 게임의 종류, 필요한 기능의 수준, 그리고 기술적 숙련도에 따라 가장 적합한 도구를 선택합니다.

Hachimi Project는 특정 게임의 경험을 개선하는 데 있어 뚜렷한 장점을 가지지만, 몇 가지 고려해야 할 단점도 존재한다.

주요 장점으로는 비파괴적 패치 방식이 꼽힌다. 이 방식은 게임의 원본 파일을 직접 수정하지 않고 별도의 레이어를 통해 패치를 적용하므로, 게임 파일 손상 위험이 적고 패치 제거가 간편하다. 또한 그래픽 사용자 인터페이스를 제공하여 명령어 입력 없이도 쉽게 설정하고 적용할 수 있다. 프로젝트는 활발한 커뮤니티에 의해 지속적으로 관리되고 업데이트되며, 새로운 기능과 호환성 개선이 이루어진다.

반면, 명확한 단점도 존재한다. 가장 큰 제약은 지원하는 게임의 범위가 비교적 한정적이라는 점이다. 주로 특정 일본산 비주얼 노벨이나 오래된 게임 엔진을 사용하는 타이틀에 집중되어 있다. 또한 이 프로젝트는 게임 개발사의 공식 지원을 받지 않는 비공식 도구이므로, 사용에 따른 모든 책임은 사용자에게 있다. 일부 온라인 게임이나 안티 치트 시스템이 활성화된 게임에서 사용할 경우 계정 제재를 받을 수 있는 위험이 있다. 마지막으로, 고급 설정 옵션은 게임 모딩에 익숙하지 않은 초보 사용자에게는 다소 복잡하게 느껴질 수 있다.